Informática Multimedia 1995 April

home *** CD-ROM | disk | FTP | other *** search

/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / FILECOPY / LUP102.ZIP / LUP.DOC < prev next >

Wrap

Text File | 1994-02-09 | 56.4 KB | 1,465 lines

Lodji Utility Program (LUP), Version 1.02 by David W. Roscoe USER MANUAL CONTENTS INTRODUCTION .................. 2 QUICK START ................... 3 ACKNOWLEDGEMENTS .............. 3 SHAREWARE AND REGISTRATION .... 3 REQUIREMENTS .................. 4 INSTALLATION .................. 4 CONFIGURATION ................. 5 NOTATIONS ..................... 5 STARTING THE PROGRAM .......... 6 USING THE PROGRAM ............. 6 EXITING THE PROGRAM ........... 7 MENUS ......................... 7 HELP .......................... 8 VIEWING DIRECTORIES ........... 8 INCREMENTAL SEARCHING ......... 9 VIEWING MULTIPLE DIRECTORIES .. 9 VIEWING ARCHIVES .............. 10 VIEWING FILES ................. 11 COPYING FILES ................. 12 DELETING FILES ................ 12 RENAMING FILES ................ 13 EXTRACTING FILES .............. 13 DEMONSTRATION ................. 13 PERFORMANCE ................... 13 FILES USED BY LUP ............. 14 TECHNICAL SUPPORT ............. 16 FREE REGISTRATION UPGRADES .... 18 REVISION HISTORY ............. 19 KNOWN PROBLEMS ................ 19 1 INTRODUCTION LUP (pronounced "loop") is a directory and archive viewer and file extractor, and a simple file manager. It was designed to be useful to anyone who receives, compares, or maintains large collections of files. This includes CD-ROM publishers, BBS operators, shareware venders, or anyone who receives their products or services. LUP's commands are available through command keys, context sensitive menus on demand, and help, making LUP easy to learn and use. LUP can display the contents of both DOS directories and archive files. With LUP you can view the contents of files, whether they are in DOS directories, archive files, or subdirectories inside of archive files. LUP also supports archive files inside archive files, in other words, nested or embedded archive files. Viewing the contents of archive files with LUP is just like viewing regular DOS directories. In fact, the directory of an archive file looks just like an extension of the DOS subdirectory tree. This virtual extension also applies to subdirectories in the archive file if the archive format supports this, and to other archive files in the archive file. LUP has a built in viewer for examining text files. This includes files inside of archive files. You need not extract the files first. LUP extracts them to temporary files automatically when needed and deletes them when you exit LUP. LUP can extract files from archives. It does this automatically as part of the regular file copy command if the files you are trying to copy are inside of one or more archives. Besides copying, LUP has other simple file management functions such as file deletion and renaming. These commands work on both regular files or directory files. Also LUP can display more than one directory or archive at the same time. Unlike many other programs, which display each directory in a separate screen window, LUP displays them in a single window. If two files have the same name and appear identical then their display occupies a single line, allowing more files to be fit on a screen. Files which appear different are displayed on more than one line in a way which emphasizes their differences such as length and time stamp. This makes it easy for you to detect new, changed, or deleted files. This feature is especially useful when comparing related groups of files, such as a directory and its backup copy, or two versions of the same software package or data set. When you move from one subdirectory to another LUP attempts to do similar moves for each subdirectory being displayed so that related files are automatically displayed together. 2 LUP presently supports [.ARC], [.LZH], [.ZIP], and [.ZOO] archives. Support for other archive file types is being added. QUICK START This section is for those who want to get LUP running quickly. If you are an experienced user but are not sure whether LUP will work on your computer then skip to the REQUIREMENTS section, then the INSTALLATION section. If you are an experienced user and have a fairly powerful computer you can probably skip directly to the INSTALLATION section. ACKNOWLEDGEMENTS I must thank several people for helping me to produce this program. First, I thank Robert Schenot for writing "The ShareWare Book". His book is full of useful information on the software business, with special emphasis on Shareware as a distribution channel. It has saved me many hours of work. I thank my Beta testers, most of whom are members of the Boston area SMUDGE computer user group. Special thanks to Jim Van Zandt and Irv Bosinoff for their valuable feedback. I give my greatest thanks to Brad Hare for putting LUP through grueling stress tests. He used LUP to view and extract files from [.ZIP] archives from CD-ROMs and computer systems all over the country. If LUP is mostly bug free then it is partially because Brad found most of the bugs for me. SHAREWARE AND REGISTRATION This product is distributed as Shareware, a Try-Before-You-Buy approach to software distribution. Please feel free to use LUP free for up to 30 days to ensure that it meets your needs. If you decide to continue using LUP you must register with the author. Your registered copy of LUP will include: the latest release of the software, a printed user manual, a registration key to disable the production of registration reminder messages from the program, 90 days of support, upgrade notices, and maybe some other miscellaneous software. To obtain a registered copy of LUP use the <Alt-R> (Register) command in the LUP File Lists Viewer. The File Lists Viewer is 3 active when LUP first starts. The Register command will produce a registration form which will make your registration easier for both you and me. See the section LICENSE AGREEMENT for more information. REQUIREMENTS LUP will run on your computer if your computer is an IBM PC compatible running MS-DOS or PC-DOS version 3.0 or later, has 400K of disk space, and has 640K of Random Access Memory (RAM). If you plan to use LUP to examine archives then you must also have the appropriate archive program in a directory in your DOS PATH. The archive programs are available from most electronic bulletin board systems. The presently supported archive file types, the archive programs needed to access them, are listed below: [.ARC]: PKUNPAK.EXE v3.61, packaged in PK361.EXE, a self extracting [.ARC] file, along with its companion program PKPAK. This may be the last version of an archive program produced by PKWARE which supported the [.ARC] format. Earlier versions of these programs were called PKXARC and PKARC. PKWARE abandoned the [.ARC] format and developed the now much more popular [.ZIP] format after settlement in 1988 of a lawsuit by System Enhancement Associates against PKWARE. Note, [.ARC] format does not support subdirectories. [.LZH]: LHA.EXE v2.13. packaged in LHA213.EXE, a self extracting archive file. [.ZIP]: PKUNZIP.EXE v2.04g. packaged in PKZ204G.EXE, a self extracting [.ZIP] file, along with its companion program PKZIP. They can also be obtained from: PKWARE, INC.; 9025 N. Deerwood Dr.; Brown Deer, WI 53223; USA [.ZOO]: ZOO.EXE v2.1. packaged in ZOO210.EXE, a self extracting archive file. LUP was tested with these particular versions. It will probably run with other versions. However, if you have newer versions of these archive programs with which LUP does not work then please notify me. If you plan to run the DEMO.BAT demonstration script then you will need both PKUNZIP.EXE and its companion program PKZIP.EXE. INSTALLATION To install LUP, copy all of the distribution files to an empty subdirectory. I suggest the subdirectory name "\LUPnnn" where 4 "nnn" are the digits of the version number. If you set your default directory to this subdirectory then you will be able to run LUP. If you want to be able to start LUP from any default directory without using LUP's directory in the command then you must follow some additional steps. The files LUP.EXE and LUP.DOC must be in a directory which appears in your DOS PATH. You can do this either by adding LUP's subdirectory to your DOS PATH, or by copying LUP.EXE and LUP.DOC to a directory which is already in your DOS PATH. LUP.DOC should be in the same directory as LUP.EXE because this is needed by the Help command. If you plan use LUP to access archive files then you must also have archive programs installed in your DOS PATH for each type of archive. See REQUIREMENTS for more information on these archive programs. If your copy of LUP is a registered copy then you have one more step to perform. See the section called DISABLING REGISTRATION REMINDERS. CONFIGURATION This version of LUP has no configuration options. LUP tries to adapt to the type of computer and the video mode you are using when you run it. LUP will adapt to monochrome or color display adapters. It will adapt to different screen dimensions, for example, 25 lines, 43 lines, or 50 lines. See the documentation on the DOS MODE command, or whatever command you use to control your video display, for more information. NOTATIONS The notation <KEY_NAME> represents the pressing of a key. KEY_NAME represents the name of key. Usually this is the text printed on the top of the key. For example <Esc> represents the Escape key. On most computers the text "Esc" is printed on the top of this key. Some keys have no text printed on them. For example the down arrow key usually has a picture of an arrow pointing down, but no text. In this documentation these picture keys are represented by angle brackets enclosing text which approximately describes this picture. For example, the down arrow key is referenced by <Arrow-Down> The notation [FILE_TYPE] represents a file type. The file type implies a way of interpreting the file. FILE_TYPE is the name of the type. For example, [.ZIP] represents a file created by PKZIP or similar program. FILE_TYPE may or may not be the same as the file name extension. For more information see VIEWING 5 ARCHIVES. The notation {SPECIAL} represents a special list item where SPECIAL is the name of that item. You may see this in the File List Viewer or the Path Picker. The program takes special action when you press the Enter key while the cursor is on one of these items. The action is suggested by the value of SPECIAL. For example, pressing <Enter> when the cursor is on {Parent} in the File List Viewer causes the parent directory or directories to be displayed. STARTING THE PROGRAM The simplest method of starting LUP is simply to type "LUP" from the DOS prompt. Type: LUP<Enter> The "<Enter>" stands for the Enter key. LUP will execute and display the File List of the current working directory in the File Lists Viewer. From there you may change the File Lists being displayed, move elsewhere in the directory tree, or perform other file operations. To make LUP begin by displaying one or more File Lists other than the current working directory, simply add their names to the DOS command line. For example, suppose C:\PROJECT1 contains your files of a particular project, and a floppy diskette contains previously saved versions of those files, and you want to see which files have changed since you saved them. To do this, place the diskette in drive A: and at the DOS prompt type: LUP C:\PROJECT1 A:<Enter> This will cause LUP to start and to display both directories simultaneously. Note, only File List specifications can appear on the command line. You can not view a text file directly from the command line, however you can do this after LUP is started. You may also specify archive files on the command line. In general you may type an archive file path name anywhere you could type a directory file path name. See VIEWING ARCHIVES for more information. USING THE PROGRAM LUP was designed to be both easy to learn and easy to use. Almost all program commands are available through context sensitive menus AND single key shortcuts. Using the menus is easy. You can begin using the program 6 immediately with the menus. If you want you can learn the shortcut keys. All shortcut keys are displayed in the menus of their associated commands, which makes them easy to learn. There is also a simple Help command which allows you to view this user manual from inside of LUP. EXITING THE PROGRAM You can quit, or exit, any part of the program using <Esc> (Escape key). If you do this in the File Lists Viewer then you are asking to quit the program and return to DOS. In this case the program will ask for confirmation before exiting. The default directory will be the one active when you started the program. You can also exit the program using the <Alt-X> (Exit to directory) from the File Lists Viewer. This command allows you to exit with the default directory set to one of the ones being displayed by the File Lists Viewer, which may not be the one active when you started the program. MENUS Menus are available from nearly everywhere in the program. You can display a menu by pressing the F10. Menus are context sensitive. This means that the commands listed in a menu vary according to the commands available at that point of the program. These commands can depend on everything from the type of dialogue box active to the position of the cursors. If you are ever not sure about what to do next, pressing F10 will produce a menu of all the things you can do at that point. For example, if the File Lists Viewer is active and you press the F10 key then a menu labeled "File Lists Viewer Menu" will be displayed which lists all the commands available from the File Lists Viewer. You will even see the F10 key listed. You can use a menu in two ways. The first way is to select one of the commands in the menu and press the Enter key to execute it. For example, in the menu of the File Lists Viewer is the menu item "<Alt-A> About this program". If you move the menu cursor to that menu item and press the Enter key then a dialogue box will be displayed which gives a brief description of the program. The other way to use a menu is as a command summary. When you see in a menu the command you want to execute, you can press the <Esc> key to exit the menu and then press the associated command key to trigger that command. Note, sometimes a menu item represents a group of commands, not 7 a single command. Group menu items end in "...". If you press <Enter> when the menu cursor is on a group menu item then another nested menu will appear. This nested menu represents the group. For example, when a list scroller is active there are several command keys available for moving the scroller's cursor. These appear as a single group menu item under the name "Line Cursor Movement...". If you press the Enter key while the menu cursor is on the "Line Cursor Movement..." item then another menu will appear which lists the actual cursor movement commands with their command keys, such as "<Arrow- Down> Forward", etc. To abandon a menu without executing one of its commands, press the Esc key. The menu will disappear. HELP If you still can't figure out how to do what you want after using the menus then you can get help by pressing the <F1> key. This will open a dialogue for viewing the user manual file, i.e., the file you are reading now. Help is available from everywhere the menus are available. VIEWING DIRECTORIES You view directories with the File Lists Viewer, which is the dialogue which fills the entire screen when you start the program. It displays one or more directories. It is divided into two major parts. The top part contains a summary of the directories displayed. Each line in the summary includes the number of the directory, the total number of bytes in all the files in that directory, the number of files including subdirectories in that directory, and the path name of the directory. It also includes the file mask, however this should probably be displayed elsewhere because all file masks must be the same. The bottom contains a list of the file entries in the directories summarized in the top part. Each entry includes the file name, the file size or if the entry is a subdirectory a notation to indicate that, the file date, file time, and the file attributes. Note, together the file date and file time make up what is called the file time stamp. This is the time the file was created or last written to. The file entry list may be scrolled using the cursor movement commands. Cursor movement commands include incremental searches. This allows you to move the cursor directly to a particular file entry by pressing the first few characters of the file name. See INCREMENTAL SEARCHING for details. 8 To display a subdirectory of the directory you are displaying, simply move the scroller cursor to the subdirectory you wish to display and press the <Enter> key. If you wish to display the parent of the directory being displayed then move the cursor the entry labeled "{Parent}" and press the <Enter> key. Using these two basic operations you can easily examine all directories on a disk. If you would like to examine the directories on a different disk drive, or would like to jump immediately to a distant directory then use the Alt-S (Substitute Path) command. If you would like to limit the display to a subset of all the files in the directory you can use the Alt-F (File Mask) command. For example to display only the files ending in ".TXT", change the New File Mask to "*.TXT". The previous commands are part of a group of commands to control the file lists displayed by the File Lists Viewer. This group is visible as the "Lists Displayed..." item in the File Lists Viewer menu. For information on the commands in this group see VIEWING MULTIPLE DIRECTORIES. INCREMENTAL SEARCHING If you are in the File Lists Viewer or the Path Picker and you know the first few characters of a file in which you are interested you can quickly move the cursor to its file entry by typing those characters on the keyboard. This is called incremental searching. Each time you press a key LUP adds that key to the search string and moves the cursor to the first file which matches that string. If the search string does not match any file entry then LUP displays a message and allows you to correct or remove that last character. The position of the character cursor within the file entry shows how many search characters have been pressed. You can remove the last character in the search string by pressing the <Backspace> key. LUP repositions the cursor appropriately. If you use one of the other cursor movement keys the incremental search string will be adjusted appropriately. Characters are removed from the tail of the search string until the search string matches the file name in the new file entry. An empty search string matches every file entry. The incremental search can usually be completely reset by pressing the <Home> key. VIEWING MULTIPLE DIRECTORIES Viewing multiple directories at the same time is similar to viewing single directories. It is also done with the File Lists Viewer however there are a few differences in the display. Each file entry may occupy more than one line, 9 between one and the number of directories displayed. If LUP finds that two files with the same name in two different directories have the same size, date, time, and attributes then it displays then on the same line. Otherwise it puts them on two different lines. The numbers in the column headed with "**..." indicate which directories a given version of a file is in. The different file versions are ordered by date and time with the newest files first. Any line which does not have numbers in every position of the "**..." column indicates some type of difference, either a new file, a deleted file, a changed file, a file with different attribute bits, etc. This is the column which makes finding differences between directories easy. The directories being displayed are summarized in the top of the two rectangular display areas on the screen. The directories are ordered alphabetically by name. The set of directories being displayed can be changed by using the File Lists Viewer, Lists Displayed... commands. With them you can add a directory, remove a directory, or substitute a directory in the set of directory or archive files being displayed. If you want to add a directory to the File Lists Viewer use the <Alt-I> (Include Path) command. If you want to remove one from the File Lists Viewer use the <Alt-E> (Exclude Path) command. Note, in earlier versions this was called Eliminate Path. The name was changed because the old name suggested that it may delete files, however it merely removes them from the display. If you want to change one then use the <Alt-S> (Substitute Path) command. VIEWING ARCHIVES Viewing archive files is very similar to viewing directory files. To view an archive file, move the cursor of the File Lists Viewer to the file entry of the file and press the <Enter> key. The File Lists Viewer will display the contents of the archive file as a list of the files it contains. The archive file must be one of the archive types supported. You may move between the subdirectories of an archive file just like DOS subdirectories. You may even move into archive files inside of archive files, in other words, nested archive files. You may also display regular DOS directory listings and archive listings at the same time to compare them as described in the section on VIEWING MULTIPLE DIRECTORIES. Normally LUP decides how to view a file by examining the file name extension. For example, the names of most [.ZIP] files end in ".ZIP". However not all archive files end in their standard name extensions. There are two ways to view an archive file which does not have 10 the file name extension normally associated with it. One way is to use the File Lists Viewer <Alt-V> (View with selectable method) command. This command displays a list of ways to view the file. You may move the cursor to the appropriate archive type and press <Enter>. This will cause LUP to try to display the file as that type of archive file. For example, a self extracting [.ZIP] file whose name is FILE.EXE may be examined as a [.ZIP] archive by using the <Alt-V> command and selecting the [.ZIP] view option. The other way to view an archive file with a nonstandard name extension is to use the [FILE_TYPE] notation to specify an archive type. Any place where LUP accepts the path name of an archive file, for example on the command line or in the "Substitute Path" command, you may use an optional archive file type specifier. For example, you may specify a self extracting [.ZIP] file whose name is FILE.EXE by "FILE.EXE[.ZIP]". There is a class of archive files which get special treatment. Often an archive file which contains files in subdirectories also contains their subdirectories. For example, if a [.ZIP] file contains an entry for a file "SUB\FILE.TXT" then it probably also contains an entry for the subdirectory "SUB\". LUP will display the entry for this subdirectory in the usual manner. However if the entry for subdirectory "SUB\" is missing then LUP must simulate its presence. A listing of the contents of such a [.ZIP] file will contain a simulated entry for the subdirectory. You can recognize these fake subdirectories by the impossible date and time stamp value of "1980-00-00 00:00:00". Note, some archive files created on Unix systems contain files whose names have lower case characters. LUP will convert these names to upper case when it displays them because DOS does not support lower case in its file names. VIEWING FILES To view a file, use the File Lists Viewer to display the directory or archive containing the file you would like to examine. Move the cursor to the entry for the file and press the <Enter> key. LUP displays the file. If the file has a file name extension normally associated with one of the archive file types, then LUP will display the file in a File Viewer text window which may be scrolled. If the file you want to view has an archive file type extension but you know that the file is actually a text file, or if you want to view an archive file as text, use the "View with selectable method) <Alt-V> command. This command allows you to override the normal viewing method. By default the File Viewer shows only printable ASCII 11 characters. However you may display all characters except the line-feed <LF>, which is treated as a line terminator, by using the <Alt-J> (toggle Junk filter) command. This will display all characters, whether they are printable ASCII or not. In either case LUP also does some rudimentary formatting of tab characters. If a file line will not fit on a single screen line then it will be continued to as many following screen lines as necessary. Use the <Alt-M> (toggle Multicolor lists) command to display alternate file lines in different colors and make this continuation easier to see. COPYING FILES To copy regular or directory files, use the File Lists Viewer to display the directory or archive containing the files you want copy. If you are interested in a particular one then move the cursor to it. Press the <Alt-C> (Copy regular or directory files) key. LUP will display a dialogue box with its best guesses for source path, destination path, and file mask filled in or selected. Complete filling in these values. Use the Tab key to move between value gadgets. When you have defined all values press the Enter key. LUP will begin copying files. When it is finished the destination path will be added to the File Lists Viewer if that path was not already being displayed. You may not copy into an archive file. However you may copy files out of an archive file into a DOS directory. In this case LUP will automatically extract the files. DELETING FILES To delete regular or directory files, use the File Lists Viewer to display the directory or archive containing the files you want delete. If you are interested in a particular one then move the cursor to it. Press the <Alt-D> (Delete regular or directory files) key. LUP will display a dialogue box with its best guesses for path and file mask filled in or selected. Complete filling in these values. Use the Tab key to move between value gadgets. When you have defined all values press the Enter key. If you have specified more than one file to be deleted then LUP will ask for confirmation. If you answer Yes then it will begin deleting files. You may not delete files from an archive file. 12 RENAMING FILES To rename a regular or directory file, use the File Lists Viewer to display the directory or archive containing the file you want rename. If you are interested in a particular one then move the cursor to it. Press the <Alt-N> (reName a file) key to activate the "reName a file" command. LUP will display a dialogue box with its best guesses for directory, and old name filled in or selected. Complete filling in these values and provide a new name. Use the Tab key to move between value gadgets. When you have defined all values press the Enter key and LUP will rename the file. You may not rename a file inside an archive file. EXTRACTING FILES LUP can extract files from archive files. Extracting is done automatically. There are no separate commands for extracting files. When you copy files from one location to another and the source location is inside an archive, or nested inside several archives, LUP extracts the files automatically. Whenever you view a file which is inside of an archive LUP extracts it to a temporary file first. See COPYING FILES and VIEWING FILES for more information. DEMONSTRATION The file DEMO.BAT is a batch file which demonstrates some of the unusual features of LUP, namely the ability to view archive files, and the ability to view multiple directory trees in a merged format. The demo creates some files and subdirectories in the default directory and displays instructions for you to follow to explore various features. The demonstration is not fully automated. It depends on your ability to follow instructions. To run the demonstration, set the default directory to the directory containing the LUP files, and type: DEMO<Enter> PERFORMANCE You may be able to make LUP run a bit faster if you want to. Besides running LUP on a faster computer, there are several things you can do. 13 LUP caches various calculations. This means that it saves the results of calculations in a cache in Random Access Memory (RAM). If LUP needs the result of a calculation again it may find it in the cache and not need to spend the time to calculate it again. If you can increase the amount of memory for LUP to use then it can cache more calculations and run faster. Recent versions of DOS allow you to load DOS, device drivers, and TSRs (Terminate and Stay Resident programs) into high memory, making more memory available for programs like LUP. If you can do this but have not already done so then try it. This may make some of your other programs run faster also. Since LUP accesses disk a lot, using a disk cache can make it run faster also. If you are not running a disk cache you may want to do so. This may make some of your other programs run faster also. LUP runs an archive program to read the contents of an archive file. With luck the archive program will be in your disk cache when needed. However it may be purged from the disk cache by later disk accesses, especially if your disk cache is small. If this happens then you may want to use a RAM drive instead of, or in addition to, a disk cache; and put your archive programs in a directory on the RAM drive. If you do this then you also need to have that directory in your DOS PATH, otherwise LUP will be unable to find the RAM drive copy of the archive program. FILES USED BY LUP The following files are parts of, or are created by, the LUP package: LUP.DOC: This is the file you are reading now. It is the user manual for LUP. It is also used by the Help command. LUP.EXE: This is the LUP executable. LUP.CFG: This file is created by LUP. It contains configuration information, which in this version of LUP consists of only the registration status of the program. It is always created in the directory from which the program (LUP.EXE) is run. C:\LUPTMP.$$$: This subdirectory and the files created in it are temporary files. They are deleted when LUP terminates. LUP creates temporary files when it examines the contents of archive files. DEMO.BAT: This batch file script creates some directories and files which are used to demonstrate LUP's unusual features. When executed it displays instructions for its use. REGISTER.DOC: This contains information on how to register the program. VENDOR.DOC: This contains information for disk vendors on how to distribute this software. 14 TITLE49.TXT: suggested title line of software when uploaded to electronic bulletin board systems, in 49 characters or less. KEYWORDS.TXT: suggested keywords for software when uploaded to electronic bulletin board systems. DESC549.TXT: suggested description of software when uploaded to electronic bulletin board systems, in 549 characters or less. FILE_ID.DIZ: This contains a description of the software suitable for use with certain automatic catalog and BBS file list production software. {SDA.ID}: This contains a description of the software to be used in its distribution by The SDN Project. 15 LICENSE AGREEMENT You may use LUP free for up to 30 days to ensure that it meets your needs. If you decide to continue using LUP you must receive a registered copy of the software by registering with the author. You may make any number of copies of this software, including the registration key and printed manual which come with a registered copy, with the following conditions: 1. The number of days you have been using the software does not exceed 30 days, or 2. The total number of people using any of the copies of the software at any one time does not exceed the number of registered copies owned by you. You may give (or sell) copies of the software to others, in fact you are encouraged to do so, with the following conditions: 1. The software is not modified in any way. 2. You do not mislead the person receiving the software about what that person is getting. 3. If you give (or sell) a package which includes a copy of a registration key then you must destroy or include in the same package all other copies of that key, and you must destroy or include in the same package all copies of the software associated with that key. Note, if you are a shareware disk vendor then see file VENDOR.DOC for more information. LODJI disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose. Neither LODJI, nor anyone else who has been involved in the creation, production, or delivery of this software shall be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if LODJI or an agent of LODJI has been advised of the possibility of such damages. In no event shall LODJI's liability for any damages ever exceed the price paid for the license to use software, regardless of the form of the claim. The person using the software bears all risk as to the quality and performance of the software. TECHNICAL SUPPORT Registered users are entitled to free technical support for 16 three months after registration. This support is for correcting errors in the program. If time permits support may also be provided to non-registered users and registered users beyond their free support period. You should provide all the information needed to reproduce the error. At minimum you should provide your name, the version of the software, and a description of what you did to trigger the error and a description of the error. If you are a registered user entitled to technical support you should also provide the serial number and registration key of your software. You may be asked to provide other information, such as details on your computer system, your CONFIG.SYS and AUTOEXEC.BAT files, and copies of data files associated with the problem. HOW TO CONTACT LODJI You can reach LODJI at any of the following addresses: USPS: LODJI, PO BOX 915, NORTH CHELMSFORD MA 01863-0915 CompuServe: 76360,1610 Internet: 76360.1610@compuserve.com DISABLING REGISTRATION REMINDERS To encourage you to obtain a registered copy of LUP from the author, LUP occasionally displays messages to remind you of the obligation to register. These reminders conform to the guidelines of the Association of Shareware Professionals. When you get a registered copy of LUP it includes a registration key with which you can disable registration reminder messages. The disabling of these messages is called "silencing". If you do not silence LUP then it will occasionally display these messages. The registration key is printed on the invoice which comes with your registered copy of LUP. Each key will silence only the copy of LUP with a particular serial number. The serial number of your copy of LUP is printed on both your diskette and your invoice. If you purchased multiple registered copies of LUP then make sure that you use the correct key for each copy. To silence your registered copy of LUP, first find the key on your invoice. It should be labeled "REGISTRATION KEY" and will have the associated serial number printed nearby. Next, at the DOS command prompt type: LUP -s kkkkkkkkkk<Enter> 17 The "-s" is the silence option. The 's' must be in lower case. The "kkkkkkkkkk" is the string of digits of the REGISTRATION KEY you found on your invoice. "<Enter>" represents the Enter key. Be sure to include spaces between the parts of the command. If LUP displays the message "Silenced" and returns to the DOS prompt then the silencing operation is successful. If it does not do this then the silencing operation failed. This probably means that you mistyped the registration key or some other part of the command. If you silence LUP but then copy it to another disk or subdirectory, or you delete the file LUP.CFG, then the new copy automatically changes so that it is no longer silenced. This allows you to easily make and give unsilenced copies of LUP to others. However it also means that if you copy LUP to another directory as part of reorganizing your hard disk then you need to perform the silencing procedure on the new copy. Please do not give your registration key to anyone else. This is a violation of your LICENSE AGREEMENT. Save a copy of your key and serial number in a safe place. I suggest writing them both here in the printed copy of this user manual. Serial number: Registration key: FREE REGISTRATION UPGRADES Once you own a registered copy of LUP you may repeatedly upgrade free to new versions for up to one year after the date of your registration. An upgraded copy is not as complete as the original registered copy because it does not include a new copy of the printed documentation or a new diskette, but it is a fully functional and silenced copy of the program. The upgrade procedure is as follows. When you learn of a new release which you want to have, get a copy from a BBS, or a friend, etc. Install it in the normal way. Then, to silence your upgrade, at the DOS command prompt type: LUP -s kkkkkkkkkk nnnnnnnnnn<Enter> As before, the "kkkkkkkkkk" is the string of digits of the REGISTRATION KEY from the invoice which came with your registered copy. The "nnnnnnnnnn" is the SERIAL NUMBER of that copy. The serial number MUST be typed in this case because it is DIFFERENT from the serial number of the upgrade. This procedure should work for any version released within one year after the shipping date of your registered copy. Note, the one year free upgrade period applies to release 18 dates, not to actual dates. The passage of time has no affect on the operation of a registered original or upgrade, and has no affect on the ability to silence it if you need to reinstall it for some reason. REVISION HISTORY 1.02 Public release, February 9, 1994. * Added support for [.ARC], [.LZH] and [.ZOO] files. * Added support for archive files which contain files in subdirectories but not the subdirectories themselves by simulating the subdirectories. * Added free registration upgrade capability. * Changed text representation of paths so [.ext] notation is used in output and needed in input only if the file type is different from the file name extension. * Added <Alt-V> (View with selectable method) command. * Add <Alt-J> command to display or hide (default) unprintable graphic characters in File Browser. * Add <Alt-M> command to display lists and files in two colors or one color (default). * Fixed readability problem with [.ZIP] files which contain certain comments. * Improved documentation, and added index and table of contents. * Increased speed slightly by: making memory management faster; reducing memory fragmentation which reduced cache purging which improved cache effectiveness. * Made several minor bug fixes and some cosmetic changes, including changing some command names and the keys to activate them. * Changed "File Lists Viewer" to never display unreadable paths. 1.00 Public release (first). KNOWN PROBLEMS After using LUP to view directories and files LUP may run a bit slower. On very rare occasions LUP may terminate with a message which says that it is unable to allocate a block of memory from its heap. If LUP terminates in this way, or if you notice a slow down and would like to restore LUP's original speed, simply restart LUP and then resume your task. This problem does not have a severe impact on the usability of LUP, so I will probably spend most of my time doing other enhancements. However this problem will eventually be solved. The slowing is caused by the LUP's memory manager purging the internal cache in an attempt to recover memory blocks. The termination happens when, after purging the entire cache, the program is still unable to find a block of memory large enough 19 to satisfy an allocation request. Usually there is enough total memory, but it is distributed in many separate blocks, and no single block is large enough to satisfy the request. This condition is called fragmented memory. 20 INDEX ACKNOWLEDGEMENTS, 3 ARC, 4 Archive type, 11 Archives viewing, 10 ASCII characters, 11 Browsing see Viewing Caches, 14 Color see display see toggle Multicolor lists CONFIGURATION, 5 Copies of this software, 16 Copy regular or directory files, 12 COPYING FILES, 12 Date see file time stamp Default directory, 5, 7 Delete regular or directory files, 12 DELETING FILES, 12 DEMONSTRATION, 13 DEMO.BAT, 4, 13 Differences between directories, 10 Directories viewing, 8 viewing multiple, 9 Directories displayed, 8 Disk cache, 14 Disk drive, 9 Display adapter color, 5 monochrome, 5 DOS command line, 6 DOS MODE, 5 DOS PATH, 5 DOS prompt, 6 Eliminate Path see Exclude Path Embedded archive files see nested Escape, 7 Exclude Path, 10 Exit see quit Exit to directory, 7 EXITING THE PROGRAM, 7 EXTRACTING FILES, 13 Extraction automatic, 12, 13 21 F1 help key, 8 F10 menu key, 7 File changed, 10 deleted, 10 new, 10 File attributes, 8 File date, 8 File entries, 8 File Lists, 6, 10 File Lists see Lists Displayed File Lists Viewer, 3, 6, 8, 9 File Mask, 9 File name, 8 File size, 8 File time, 8 File time stamp, 8 File time stamp impossible value, 11 File Viewer, 11 Files directory, 12, 13 LUP, 14 regular, 12, 13 viewing, 11 FILES USED BY LUP, 14 Group menu items, 7 Help, 5, 8 Include Path, 10 Incremental searching, 8, 9 INSTALLATION, 4 INTRODUCTION, 2 LHA, 4 LICENSE AGREEMENT, 16 Line terminator, 11 Lists Displayed..., 10 LODJI, 17 Lower case characters, 11 LUP, 2 LUPTMP.$$$, 14 LUP.CFG, 18 LUP.DOC, 5 LUP.EXE, 5 LZH, 4 Memory, 19 MENUS, 7 22 MS-DOS see DOS Nested archive files, 10 New File Mask, 9 NOTATIONS, 5 Parent of the directory, 9 PATH see DOS PATH PC-DOS see DOS PERFORMANCE, 13 PKPAK, 4 PKUNPAK, 4 PKUNZIP, 4 PKWARE, 4 PKZIP, 4 QUICK START, 3 Quit, 7 RAM, 14 RAM drive, 14 Random Access Memory, 14 Register, 3 Registered copy, 16 Registering, 16 REGISTRATION KEY, 17, 18 REGISTRATION REMINDERS, 17 REGISTRATION UPGRADES, 18 ReName a file, 13 RENAMING FILES, 13 REQUIREMENTS, 4 REVISION HISTORY, 19 Screen see display Searching see INCREMENTAL SEARCHING, 9 Self extracting archive examining, 10 Serial number, 18 SHAREWARE AND REGISTRATION, 3 STARTING THE PROGRAM, 6 Subdirectories displaying, 9 Subdirectories in archives, 10 Subdirectories in archives simulated, 11 Subdirectory, 8 Substitute Path, 9 Support see TECHNICAL SUPPORT 23 Tab characters, 11 TECHNICAL SUPPORT, 16 Time see file time stamp Toggle Junk filter, 11 Toggle Multicolor lists, 12 Unix systems, 11 Upgrades see REGISTRATION UPGRADES, 18 Upper case, 11 USING THE PROGRAM, 6 Video see display Video mode, 5 View with selectable method <Alt-V>, 10, 11 VIEWING ARCHIVES, 10 VIEWING DIRECTORIES, 8 VIEWING FILES, 11 VIEWING MULTIPLE DIRECTORIES, 9 Warranties, 16 ZIP, 4 ZOO, 4 **, 10 <KEY_NAME>, 5 [FILE_TYPE], 5, 11 { Parent }, 9 {SPECIAL}, 6 24